home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / spitfire / sfofp20.zip / SFOFP.DOC < prev    next >
Text File  |  1994-08-06  |  7KB  |  154 lines
  1.  
  2.  
  3.               ╓────────────────────────────────────────────────╖
  4.               ║       SFOFP v2.0  Zip/ARJ Old File Purge       ║
  5.               ║        For Updating Spitfire File Areas        ║
  6.               ║       Copyright (C) 1994 by Kevin Cummins      ║
  7.               ╙────────────────────────────────────────────────╜
  8.  
  9. What It Does:
  10. ─────────────
  11. SFOFP is a utility designed to help sysops that need to manage their
  12. growing file bases, by either MOVING or DELETING old files.
  13.  
  14. SFOFP determines the age of the ZIP/ARJ file by 'looking' at the files
  15. INSIDE the archive. It DOES NOT use the external file date of the ZIP or ARJ
  16. file itself as a basis for how old the file is. Instead, the date of the
  17. NEWEST file inside the archive is used to compare against a date the sysop
  18. enters at runtime.
  19.  
  20. If the file is determined to be OLDER than the sysop specified date, then
  21. the file is either moved or deleted, depending on the choice the sysop made
  22. at runtime. If the choice was to MOVE, then a directory called OLDFILES
  23. will be created one level below the default directory and all files to be
  24. moved will be relocated there, along with a copy of the file descriptions.
  25. If the choice was to DELETE, then the file is simply deleted and the
  26. description removed from SFFILES.BBS.
  27.  
  28. SFOFP also writes to a LOG file as it operates. All activities of SFOFP
  29. will be sent to this file as well as the screen for viewing while
  30. executing. SFOFP.LOG will be created or appended in the default directory.
  31.  
  32.  
  33. Considerations:
  34. ───────────────
  35. SFOFP never writes to your present SFFILES.BBS, for those of you who become
  36. apprehensive about having your file listings messed with. Once processing
  37. is complete, your old file is renamed to SFFILES.BAK and the new one takes
  38. it place.
  39.  
  40. As of this writing, I have tested both PKZIP 1.1 and 2.04g with SFOFP. Both
  41. seem to work fine, no matter which version the files were actually zipped
  42. with.
  43.  
  44. As far as speed, this will not be the fastest utility you have ever run,
  45. due the nature of the operations involved. SFOFP itself is plenty fast, but
  46. since it makes calls to PKZIP/ARJ, well.......:)
  47.  
  48. Operation:
  49. ──────────
  50. Execution is very simple. If you place SFOFP somewhere in your dos path,
  51. you can then simply change to the directory you wish to run SFOFP on,
  52. and type >SFOFP
  53.  
  54. It is mandatory that PKZIP.EXE is either in your dos path, or in the
  55. current directory when SFOFP is executed. It is optional that ARJ be in
  56. your path. NOTE* Even if your primary compression method is ARJ, you must
  57. have PKZIP in your path for SFOFP to execute. SFOFP will simply halt
  58. operation if it cannot find PKZIP!
  59.  
  60. SFOFP will first ask you if you wish to MOVE or DELETE. You will respond by
  61. typing D, M, or Q to Quit.
  62.  
  63. Next, SFOFP will ask you to input the date you wish to use as a comparison
  64. against the newest file in each archived file. Type in the number of the
  65. month, day, and year you wish to use.
  66.  
  67. SFOFP will then process each file listed in SFFILES.BBS in the default
  68. directory. Each ZIP/ARJ that does NOT have a file inside newer than the
  69. date you specified will either be moved or deleted.
  70.  
  71.  
  72. Batch Mode Operation:  (Registered Version Only)
  73. ─────────────────────
  74. Version 1.2+ is capable of running unattended in batch mode. SFOFP will
  75. accept two command line parameters. They are:
  76.  
  77.         /MOVE
  78.         /DELETE
  79.         /DATE=
  80.  
  81. You MUST specify either a /MOVE or /DELETE plus the /DATE= parameter to put
  82. SFOFP into batch mode. SFOFP will not operate in batch mode with only one
  83. parameter on the command line, as two are required.
  84.  
  85. Examples:
  86.  
  87.         SFOFP /DELETE /DATE=01/01/90    This would delete all files older
  88.                                         than 01/01/90 in the current
  89.                                         directory, listed in SFFILES.BBS.
  90.  
  91.         SFOFP /MOVE /DATE=01/01/90      This is the same as above, except
  92.                                         the files will be moved instead of
  93.                                         deleted, and their descriptions
  94.                                         saved to an oldfiles listing.
  95.  
  96.         SFOFP /MOVE                     This is invalid as a batch mode
  97.                                         command. SFOFP would revert to
  98.                                         interactive mode.
  99.  
  100.         SFOFP /DATE=01/01/92            Same results as the last example.
  101.  
  102.         SFOFP /MOVE /DATE = 06/07/93    This would be invalid, only because
  103.                                         spaces are not allowed in the
  104.                                         command line parameters.
  105.  
  106.         SFOFP /DELETE /DATE=3/1/90      This is also invalid. The date MUST
  107.                                         contain SIX integers. The preceding
  108.                                         zeros are mandatory.
  109.  
  110. Be sure to follow the examples exactly. Do not include spaces, and make
  111. sure the date is in the format: mm/dd/yy. Be certain to include any
  112. preceding Zeros in days or months less than 10, separated by a slash.
  113.  
  114.  
  115. Suggestions:
  116. ────────────
  117. I would suggest you copy one of your smaller file areas over to a test
  118. directory, and run SFOFP on it. You might feel more secure running this the
  119. first time on a dummy directory. Of course, backing up your file areas
  120. regularly is always a good idea, and you might want to back up now if you
  121. really feel uneasy.
  122.  
  123.  
  124. Registration:
  125. ─────────────
  126. All you need to make this copy registered is a registration key file, which
  127. will also be good for any future version of SFOFP. The Registration fee
  128. is only $5. Unregistered versions of SFOFP have a Shareware notice, and
  129. will only process 10 files per run, in interactive mode. Other than that,
  130. registered and non-registered versions do exactly the same job.
  131.  
  132. Creating your registration file only takes a couple seconds, and can be
  133. ready for download on Crimson Cross, usually within 24 hours after
  134. receiving your registration form.
  135.  
  136. A FORM.REG file is included for your convenience.
  137.  
  138.  
  139. Distribution:
  140. ─────────────
  141. SFOFP is released as Shareware. You are welcome to distribute it freely
  142. in it's unmodified form. You may evaluate for a period of thirty days, and
  143. are then required to register if you continue it's use.
  144.  
  145.  
  146.  
  147. Questions, Suggestion, or Comments can be directed to Kevin Cummins at:
  148.  
  149.     Crimson Cross BBS                     RIME  Network
  150.       618-253-3608                      Node: #1390 CCBBS
  151.  
  152.  
  153.  
  154.